% -*-LaTeX-*-
% Converted automatically from troff to LaTeX by tr2tex on Tue Dec 18 11:07:40 1990
% tr2tex was written by Kamal Al-Yahya at Stanford University
% (Kamal%Hanauma@SU-SCORE.ARPA)


\documentstyle[troffman]{article}
\begin{document}
%
% input file: fbnorm.1
%
\phead{FBNORM}{1}{25-Jun-90}

%.CM 3
\shead{NAME}
fbnorm -- normalize and adjust grayscale or color image
\shead{SYNOPSIS}
\nofill
fbnorm [ -b$<$val$>$ -w$<$val$>$ ] [ -$<$type$>$ ] $<$ image $>$ image
\fill
\shead{DESCRIPTION}
\par
Extends the contrast range to a full 0 to 255.  The arguments
{\bf -b}
and
{\bf -w}
given the percentage of the darkest pixels to map to black and lightest
pixels to map to white.
\par\vspace{1.0\baselineskip}
For color images the default is to discard 0.5\% each of the darkest and
lightest pixels.  Increasing the contrast beyond that may result in
significant color artifacts (because the color values will be partially
clipped).
\shead{OPTIONS}
\begin{TPlist}{{\bf -b$<$num$>$,}{\rm -w$<$num$>$}
}
\item[{{\bf -b$<$num$>$,}{\rm -w$<$num$>$}
}]
{\it percentage} black, white
pixels to map to 0, 255.  The default for grayscale images is to
"discard" 2 percent of the black pixels and 1 percent of the white
pixels.  For color images both values default to 0.5 percent.
\par\vspace{1.0\baselineskip}
An alternate form is to specify two integers, which will then be
linearly mapped to 0 and 255.
\end{TPlist}
\shead{EXAMPLE}
\par
To normalize a grayscale FBM image using defaults:
\par\vspace{1.0\baselineskip}
    \% fbnorm $<$ foo.fbm $>$ bar.fbm
\par\vspace{1.0\baselineskip}
To increase contrast by discarding 10 percent of the black pixels and 5
percent of the white pixels:
\par\vspace{1.0\baselineskip}
    \% fbnorm -b10 -w5 $<$ foo.fbm $>$ bar.fbm
\par\vspace{1.0\baselineskip}
Or, if you know that you want 34 to map to 0 and 197 to map to 255, you
can just type:
\par\vspace{1.0\baselineskip}
    \% fbnorm 34 197 $<$ foo.fbm $>$ bar.fbm
\shead{SEE ALSO}
fbm(1) for general discussion, pbm(1) for PBM routines.
\shead{BUGS}
None known.
\shead{HISTORY}
Copyright (C) 1989,1990 by Michael Mauldin.  Permission is granted
to use this file in whole or in part for any purpose, educational,
recreational or commercial, provided that this copyright notice
is retained unchanged.  This software is available to all free of
charge by anonymous FTP and in the UUNET archives.
\begin{TPlist}{25-Jun-90  Michael Mauldin at Carnegie Mellon University}
\item[{25-Jun-90  Michael Mauldin at Carnegie Mellon University}]
Release 1.0 mlm@cs.cmu.edu
\item[{07-Mar-89  Michael L. Mauldin at Carnegie Mellon University}]
Beta release (version 0.9) mlm@cs.cmu.edu
\end{TPlist}
\end{document}
